home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Spezial / SPEZIAL2_97.zip / SPEZIAL2_97.iso / ANWEND / ONLINE / HTML2I_1 / HTML2I_1.ZIP / Html2Ipf / read me, please < prev   
Text File  |  1997-04-05  |  3KB  |  46 lines
  1.  
  2. You just found the most, perhaps, exciting REXX script in your life :-)
  3. This program will help those of you who want to replace that pile of
  4. .HTML, .GIF and other files in the, say, \JavaOS2\docs\ directory with
  5. something easier to read, manage, search and so on, I mean the usual OS/2
  6. .INF books. I personally don`t like to search needed information using GREP.
  7. You too? Well, then this program is for just for you.
  8.  
  9. Since version 2.0 (and maybe even 1.2?) OS/2 have a so-called Information
  10. Presentation Facility subsystem. Well, let`s face it - it is far from
  11. perfection, especially counting that it has not been changed *at all*
  12. since 1990 :-( On the other hand, it have a very neat feature: its small
  13. and (relatively) fast. How much time loads your browser? Well, divide
  14. this time by ten and you`ll obtain the time required to load VIEW.EXE.
  15.  
  16. The processing is fully automa(g)(t)ical. You just have to launch
  17.  
  18.  HTML2IPF <index.html>
  19.  
  20. and you`re done. Of course, like any well-behaved program HTML2IPF has a
  21. number of switches, but usually you won`t need them.
  22.  
  23. The conversion process requires two stages. First (the most complex) is to
  24. convert the bunch of HTML files into a single .IPF file, and all pictures
  25. into the plain dumb .BMP format. Once you`re done, you just have to
  26. run IPFC on this IPF file and you`ll get the final .INF file! (of course,
  27. if no fatal errors will happen - and usualy they don`t).
  28.  
  29. To try it just now, go into the doc/ subdirectory and launch MAKEINF.CMD.
  30. The documentation for the HTML2IPF is provided in HTML format, but you
  31. can convert it into INF format and delete the pile of HTML and GIF files.
  32. For this script to work properly, you`ll need the Image Alchemy for OS/2
  33. to convert GIF files into OS/2 BMP. If you don`t have it - don`t worry, you
  34. have many other ways to do it. If you`re running OS/2 v4.0 (Merlin) you can
  35. pre-convert GIF files by right-clicking on them and selecting Convert to->
  36. Bitmap->OS/2 v1.3 format (I REPEAT: v1.3 NOT THE 2.0 FORMAT!). If you
  37. have Warp 3.0 you can use any suitable conversion tool (say PMView),
  38. or even a DOS tool (aaaaargh! if you`ll do it, you`ll lose the nifty
  39. character cases in names).
  40. The second thing you`ll need for this process to complete, is the
  41. Information Presentation Facility Compiler, i.e. IPFC.EXE. It is included
  42. into OS/2 Developer`s Toolkit. Set up it properly (if you installed
  43. the Toolkit, the installer already done it) - the only thing it requires
  44. is a SET IPFC=#:\toolkit\ipfc environment variable. Now you can run
  45. MAKEINF.CMD and see what`ll happen.
  46.